Skip to content

feat: add debugging hints to agent system prompt and reference docs#92

Merged
cristipufu merged 1 commit intomainfrom
feat/agent-debugging-hints
Mar 1, 2026
Merged

feat: add debugging hints to agent system prompt and reference docs#92
cristipufu merged 1 commit intomainfrom
feat/agent-debugging-hints

Conversation

@cristipufu
Copy link
Member

Summary

  • Add ## Debugging section to agent system prompt in loop.py with triage steps and common error patterns (score 0.0 = crash, ModuleNotFoundError, schema mismatch, __future__ annotations, missing env vars)
  • Expand Troubleshooting section in evaluations.md with actionable diagnostic steps instead of generic bullets
  • Expand Error Handling section in running-agents.md with concrete error patterns and fixes

Test plan

  • uv run ruff check src/ — passes
  • uv run ruff format --check . — passes
  • uv run mypy src/ — passes
  • Start agent harness, ask "my eval is scoring 0 on everything" → agent uses debugging protocol

🤖 Generated with Claude Code

When evaluations fail because the function crashes (not wrong logic),
the agent had no guidance on diagnosing the issue. Add structured
debugging protocol to the system prompt and expand troubleshooting
sections in evaluations.md and running-agents.md with concrete error
patterns and fix steps.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cristipufu cristipufu merged commit eb43ff4 into main Mar 1, 2026
11 checks passed
@cristipufu cristipufu self-assigned this Mar 1, 2026
@cristipufu cristipufu deleted the feat/agent-debugging-hints branch March 1, 2026 12:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant